home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / os20 / util / pubchange012.lzh / PubChange / PubChange.doc < prev    next >
Text File  |  1993-01-10  |  6KB  |  167 lines
  1.  
  2. NAME
  3.  
  4.    PubChange   (>= OS 2.0 commodity to change the default public screen)
  5.  
  6.  
  7. AUTHOR, VERSION & COPYRIGHT
  8.  
  9.    Steve Koren
  10.    Version 1.2, January 1993
  11.  
  12.    Requires AmigaDos 2.04 or later
  13.  
  14.    PubChange is copyrighted freeware.  It may be distributed on PD disk
  15.    collections costing no more per disk than the price of a current Fish
  16.    disk.  PubChange may be uploaded to BBS systems.  It may not be sold
  17.    for a profit or modified without permission of the author.  However,
  18.    you are free to give it away to friends, etc.
  19.  
  20.  
  21. SYNOPSIS
  22.  
  23.    PubChange [ CX_PRIORITY=n ] [ NEXTSCREEN=string ] [ PREVSCREEN=string ]
  24.              [ WBSCREEN=string ] [ CURRSCREEN=strings ]
  25.  
  26.    Where:
  27.       NEXTSCREEN = The AmigaDOS commodity key specification to bring the
  28.                    next screen to the front.
  29.  
  30.       PREVSCREEN = The AmigaDOS commodity key specification to bring the
  31.                    previous screen to the front.
  32.  
  33.       WBSCREEN   = The AmigaDOS commodity key specification to bring the
  34.                    workbench screen to the front.
  35.  
  36.       CURRSCREEN = The AmigaDOS commodity key specification to set the
  37.                    default public screen to the topmost screen.
  38.  
  39.    See your AmigaDos manual for a description of acceptable commodity
  40.    strings.
  41.  
  42.  
  43. FUNCTION
  44.  
  45.    Brings the next (or previous) screen to the front, and if this new
  46.    screen is a public screen, it is made into the default.  "Shanghai"
  47.    mode is not affected.  It is especially useful with "POP CLI"
  48.    Commodities or other commodities which launch applications on the
  49.    default public screen.  For best rests, it should be used in
  50.    conjunction with a public screen manager utility.
  51.  
  52.  
  53. DESCRIPTION
  54.  
  55.    Public screens in AmigaDos 2.04 and higher are useful to increase the
  56.    size of your working environment or to open windows on application
  57.    screens.  There are many public screen managers available to perform
  58.    the task of opening and closing these public screens in various
  59.    configurations.  However, the use model is not quite intuitive; you
  60.    must always take an explicit and often cumbersome step to make the
  61.    new public screen into the default.  If you fail to do this, all your
  62.    windows will open on the old default public screen instead of the one
  63.    in front.  There are several utilities to pop the current public screen
  64.    to the front whenever a new window opens on it, but I found that
  65.    exactly backwards.  Instead, I preferred that whichever screen happens
  66.    to be in front is made into the default public screen.
  67.  
  68.    PubChange is designed to provide a more intuitive use model.  The
  69.    concept is that whichever screen you bring to the front becomes the
  70.    default screen at the same time as it is brought to the front.  Any
  71.    windows which ask to open on the default public screen will open on
  72.    this screen.
  73.    
  74.    PubChange is a commodity and can be disabled or killed with the
  75.    Commodity Exchange.  It does not have a graphical user interface.
  76.    Instead, it is controlled via workbench icon tooltypes or command line
  77.    arguments.  It should be installed in the WBStartup directory.  The
  78.    supported tooltypes are:
  79.  
  80.       CX_PRIORITY=<n>
  81.       NEXTSCREEN=<string>
  82.       PREVSCREEN=<string>
  83.       CURRSCREEN=<string>
  84.       WBSCREEN=<string>
  85.  
  86.    NEXTSCREEN brings the next screen to the front, and if this screen is a
  87.    public screen, it is made into the default.  PREVSCREEN brings the
  88.    previous screen to the front, and if it is a public screen it is made
  89.    into the default.  WBSCREEN always brings the workbench screen to the
  90.    front, and this is made into the default public screen.  CURRSCREEN will
  91.    set the default public screen to the frontmost screen (useful if you
  92.    used something besides PubChange to bring a screen to the front).
  93.  
  94.    NOTE: PubChange will *not* set "Shanghai" mode in the public screens it
  95.    brings to the front.  Use your public screen manager to do this for
  96.    alternate public screens, or use the application which has opened the
  97.    public screen to do it for application public screens.
  98.  
  99.    NOTE: If the most recent screen brought to the front with PubChange is
  100.    not a public screen, the default public screen will remain the same as
  101.    it was before this screen was brought to the front.
  102.  
  103.    PubChange can be stopped with the Commodity Exchange, or by double
  104.    clicking again on its workbench icon.  If it detects an error when run
  105.    from workbench, it exits with no error message.  If launched from the
  106.    CLI, it uses its command line parameters as tooltypes, and will set a
  107.    return code as listed below.
  108.  
  109.    The default values for the tooltypes are:
  110.  
  111.       CX_PRIORITY=0
  112.       NEXTSCREEN=lcommand m
  113.       PREVSCREEN=lcommand p
  114.       CURRSCREEN=lcommand c
  115.       WBSCREEN=lcommand w
  116.  
  117.    Thus, the left amiga-M combination cycles through screens just as it
  118.    did without PubChange installed, but new screens brought to the front
  119.    will be made into the default public screen.
  120.  
  121.    NOTE:  PubChange was written under AmigaDos 3.0.  However, it only asks
  122.    for 2.04 libraries (V37), so it should also work fine under 2.04.
  123.    However, I haven't been able to test this.
  124.  
  125.    A good public screen manager to use with PubChange is "ScreenManager",
  126.    (sm_1_13c.lzh), a freeware utility by Bernhard M Llemann.  This utility
  127.    lets you set up public screens non-interactively from a startup script,
  128.    in any screen mode in the display database.
  129.  
  130.  
  131. RETURN VALUES
  132.  
  133.    17    - Unable to allocate Cx broker.
  134.  
  135.    18    - Unable to allocate Cx object;
  136.  
  137.    19    - Can't create a message port.  Out of memory?
  138.  
  139.    20    - Can't open an AmigaDos library.  PubChange needs V37 libraries,
  140.            as used by AmigaDos 2.04 or later.  It won't run under 1.3.
  141.  
  142.  
  143. KNOWN BUGS
  144.  
  145.    B1. PubChange does not print out a usage message if called from the
  146.        CLI.  It is best to install it into your WBStartup drawer
  147.  
  148.    B2. There is no GUI.
  149.  
  150.    B3. PubChange doesn't look at the screen "back" gadget - only the
  151.        keyboard equivalents.  Perhaps in the next version.
  152.  
  153.  
  154. BUG REPORTS
  155.  
  156.    Send bug reports to me at:
  157.  
  158.    Steve Koren
  159.    405 Pulsar St.
  160.    Fort Collins, CO 80525 USA
  161.  
  162.    303-226-4985 (USA)
  163.  
  164.    koren@fc.hp.com (email)
  165.  
  166.    I may or may not fix them.  Can't hurt to try though.
  167.